Installation guide: step by step

This document will guide you through the installation steps of the softwares needed for the hands-on sessions.
The steps are self-explainable, please perform all the installation steps in the menu on the left, prior to the workshop.

Don’t worry about your operating system. We have written installation options for Windows, Mac, and Linux.

Estimated time needed for this installation: 30 min - 1 hour

After finishing this guide, you have a working installation of:
- RStudio Desktop 1.4.1106 and >R4.0, and packages
- Python, Julia, manta, anuran, FLASHWEaVE - Circos

Let’s get started!

Installation of Rstudio and R

R and RStudio are the basic programs used in this course. If you have already an R-version installed, take a moment to check if you are running the same version, R4.0.4. Our install will not mess up previous installed R-instances. So we recommend you to follow the R installation steps.

  1. For windows, you need RStudio for windows, and R-version 4.0.4 for windows. For Mac, you can download RStudio for Mac and R-version 4.0.4 for Mac. For Linux, e.g. Ubuntu 20.04, follow these instructions. If you have an account on the Flemish supercomputer and need help to Run R from there, mail me: . For other OS, read here. Execute the RStudio.exe and also the R4.0.4.exe, using the default settings.
    Tip: Choose language in English, if you want us to help understand error messages :-)

  2. Make a folder called MDAW e.g. in C:/Users/yourname/Documents. In this folder, place the MDAW.zip file provided to you via google drive, and Unzip it.

  3. Go to the MDAW folder that you created in step 2. Double click on the MDAW.Rproj, it will open in Rstudio. Click file, open file, and navigate to your MDAW folder, and open the file 1.Initialise.R. In RStudio, please first check if you are using R 4.0.4 version. For this click, Tools > Global Options > and check which version is loaded under ‘R version’, select the 4.0.4 version if not already there. Click Apply, Ok. Now you are ready to run 1.initialise.R.
    Follow the instructions in the 1.Initialise.R file and execute all steps.
    The last command renv:restore can take 1 hour because it will auto-install all packages needed for the workshop, in the meantime you can watch this 15 min video to learn the basics of R, what is the console etc. and get familiar with the commands setwd and getwd().

  4. All done for Rstudio and R! You can proceed with the installation of the softwares for Tutorial4 and 5.

Download and Installation instructions for Circos (Tutorial4)

With Circos you can visualise the correlations between microbiome data, transcriptomics data and various metadata such as metabolomics data-sets.

Sneak preview:

Installation option 1: “hard way”

1)Download Circos
2)Install Circos

Installation option 2: Virtualbox
If the above didn’t work, follow the virtualbox installation instructions in which circos was pre-installed.

Installation of Julia, python (Tutorial5)

For the network analyses Tutorial#5 by Sam Röttjers, you need to install the following softwares.

Installation option 1: “hard way”

1)Install FlashWeave (and Julia)

2)Install Python 3

3)Install PyCharm or another Python editor of choice

4)Install manta

5)Install anuran

Installation option 2: Virtualbox
If you have donwloaded and installed the virtualbox (VB) in the previous tab (for the installation of circos), then you are good to go because in the VB all the softwares are pre-installed, also python, anuran. You can run the small test for manta, as explained

All done!

If you had installation problems, you can schedule a one-one meeting with me in Gather-town, from April 12. You can mail me to find an appropriate time: .